HELP

mapaDist				package:desconhecido		R Documentation

Calcula uma matriz de distncias entre os polgonos da classe de uso escolhida a partir de um arquivo de entrada de uso da terra no formato shape.


DESCRIO

mapaDist calcula um mapa de distncias entre os polgonos da classe de uso da terra informada pelo usurio no argumento "classe",a partir de um arquivo no formato shape, com uso da funo gDistance;
Padroniza o arquivo de entrada (shapefile), criando uma coluna de identificador (Ident) e calculando a rea (coluna (gArea)) para os polgonos da classe de uso selecionada.
Cria arquivos de sada com as seguintes informaes dos polgonos da classe de uso selecionada para o clcula das distncias: (1)identificador e rea;(2)identificadores e distncia entre duplas de polgonos; (3)arquivo formato shape; (4)arquivo com projeo espacial e georreferncia do shape. 


USO

mapaDist(x="",Dir="",dirOutShape="",classe="")


ARGUMENTOS

x 		Diretrio e nome do arquivo (.shp) de entrada; no deve ter a extenso o nome e deve ser colocado entre aspas. O arquivo de entrada deve ter o formato shapefile (.shp,.shx,.dbf,.prj,.sbn,.sbx,.xml).

Dir 		Diretrio onde est salvo o arquivo de entrada e onde sero salvos parte dos arquivos de sada; Esse diretrio no deve ser mais longo do que dois nveis da raz. 

dirOutShape 	Diretrio onde ser salvo o shapefile gerado pela funo; Esse diretrio no deve ser mais longo do que dois nveis da raz. Ele  necessrio, pois o shape no salva no mesmo diretrio dos outros arquivos.

classe 		Classe de uso do solo que se deseja calcular a distncia entre os polgonos; A identificao das classes dever estar em uma coluna chamada Id_classe.


DETALHES

A funo mapaDist automatiza a leitura do arquivo shape e o clculo da matriz de distncia (mapa de distncias) entre polgonos de uma mesma classe de uso da terra. Um os usos dessa funo  a produo da matriz de distncias, necessria para o clculo de ndices de conectividade. 
Os arquivos de sada .txt possuem formato ideal para ser usado no clculo de conectividade no programa Conefor Sensinode. O shapefile de sada (shape_out) com os polgonos da classe de uso selecionadas facilitam que outros dados (ex.: conectividade e distncias) sejam cruzados com eles.

Os diretrios informados pelos argumentos "Dir" e "dirOutShape" devem possuir caminho, no mximo, dois nveis distantes da raz (C:, D:,...). Caso contrrio aparecer uma mensagem de erro (...) e a funo no executar. 

O arquivo shape criado pela funo  salvo no diretrio especificado pelo argumento dirOutShape (diretrio de sada do shape), pois a funo writePolyShape no executa no mesmo diretrio dos outros arquivos

Para abrir o arquivo shape georrerenciado em um programa de SIG  necessrio salvar o arquivo .prj (gerado pela funo no diretrio informado por "Dir") na mesma pasta em que esto salvos os arquivos shape (.shp, .dbf e .shx)

So requeridos os pacotes sp, rgeos, maptools,utils,reshape e plyr.


VALOR

Retorna os seguintes objetos:

selecao.dist: data frame com colunas identificador dos poligonos da classe de uso selecionada (Ident) e sua rea (gArea).

selecao.out: data frame com identificadores (Ident) e distncia entre os polgonos da classe de uso selecionada.

Cria os arquivos:

x_out:  arquivo .txt com colunas identificador dos poligonos da classe de uso selecionada (Ident) e sua rea (gArea). O arquivo  salvo no diretrio de trabalho identificado pelo "Dir".

x_dist: arquivo .txt com identificadores (Ident) e distncia entre os polgonos da classe de uso selecionada. O arquivo  salvo no diretrio de trabalho identificado pelo "Dir".

shape_out: arquivo shape (".shp",".shx",".dbf") com os polgonos da classe de uso do solo selecionada; arquivo  salvo no diretrio identificado pelo "dirOutShape".

shape_out: arquivo .prj; sistema de projeo e georreferncia do shape criado;  salvo no diretrio de trabalho identificado pelo "Dir".


ERRO

Ao trmino da execuo da funo aparece a seguinte mensagem de aviso: "In readLines(paste(x, ".prj", sep = "")) :  linha final incompleta encontrada em 'x.prj". Entretanto, todos os arquivos so gerados.


AUTORA

Karine Machado Costa
karine.costa@ib.usp.br

EXEMPLOS

Utilizar o arquivo shape_uso_R e uso_solo_tr